home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / util / moni / lcdcpu.lha / lcdcpu.doc next >
Encoding:
Text File  |  1996-08-31  |  3.8 KB  |  87 lines
  1. lcdcpu.doc
  2.  
  3. NAME
  4.      lcdcpu - display a CPU meter on external LCD
  5.  
  6. VERSION
  7.      V1.02 - 30.08.96
  8.  
  9. SYNOPSIS
  10.      lcdcpu Interval/N,Toggleint/N,Clock/S,Mem/S
  11.  
  12. REQUIREMENTS
  13.      - the "Executive" task scheduler. lcdcpu uses Executive's
  14.        "SysInfo.library" to read current CPU load.
  15.      - the "LCDaemon" hard- and software project. Minimum LCDaemon version
  16.        is V1.6, previous versions didn't support programmable characters.
  17.  
  18. DESCRIPTION
  19.      I got the idea for lcdcpu from an SGI machine on CeBit where they had
  20.      a small LC display to show the current load of the 16 or so CPUs :-)
  21.      As the "LCDaemon" project (available on AmiNet in hard/hack) allows to
  22.      connect an LC display to the Amiga's parallel port, I decided to
  23.      complement the Executive task scheduler package (on AmiNet as well)
  24.      and LCDaemon to give a similar display. Optionally it can also show a
  25.      clock and/or memory meter.
  26.      Parameters are as follows:
  27.        - Interval/N:  interval between two display updates in seconds
  28.        - ToggleInt/N: number of updates to pass before toggling between
  29.                       clock and memory display
  30.        - Clock/S:     show a clock below the CPU bargraph
  31.        - Mem/S:       show free memory in KB
  32.      If both Clock and Mem are specified, lcdcpu will simply toggle
  33.      between both. Default is to toggle every third display update if
  34.      nothing else was specified with ToggleInt/N. Giving TglInt/N alone
  35.      makes lcdcpu assume you want both Clock/S and Mem/S.
  36.      If you don't want either aof them, some percent values for the
  37.      bargraph will be printed in the second line. 
  38.  
  39. BUGS
  40.      - It seems in non-exclusive display access mode (display may be shared
  41.        by multiple programs, which is a feature of LCDaemon I do not want
  42.        to switch off) it's not possible to make the cursor invisible.
  43.        Looks quite ugly :-(
  44.      - Can only use the upper two lines of multi-line LCDs
  45.      - Crashes if Executive is not running. This seems to be a
  46.        SysInfo.library problem though, especially because its signal
  47.        notficaion system is also buggy. I hope Executive 2.0 will fix this
  48.        problem (maybe prevent SysInfo.library from opening if Executive is
  49.        not running).
  50.  
  51. HISTORY
  52.      V0.9      (09.06.96)     First release
  53.  
  54.      V1.0      (27.08.96)     Oops...there actually *were* bugs :-)
  55.                               This is in fact almost a complete rewrite.
  56.                               - Implemented programmable character support
  57.                                 for a nicer bar.
  58.                               - removed some unnecessary sysinfo.library
  59.                                 calls when using update intervals > 1.
  60.                               - Fixed possible problems with VMem (some
  61.                                 structures which should have been "static"
  62.                                 were not)
  63.                               - sysinfo.library's name has changed to
  64.                                 "SysInfo.library" :-(
  65.  
  66.      V1.01     (29.08.96)     - Some source cleanup, also made the
  67.                                 executable smaller.
  68.                               - One unnecessary custom char was allocated
  69.                                 on the LCD. Fixed.
  70.                               - On at least 18 characters wide displays,
  71.                                 the clock display now shows seconds.
  72.                               - More meaningful errormessages & returncodes
  73.  
  74.      V1.02     (30.08.96)     - Specifying TglInt/N is now sufficient to
  75.                                 activate both clock and memory display.
  76.  
  77. TODO
  78.      - more Executive system statistics maybe...
  79.  
  80. AUTHOR
  81.      Matthias Bethke
  82.      Giessener Strasse 31
  83.      35457 Lollar
  84.      Germany
  85.      postmaster@sweetdreams.lahn.de
  86.      Matthias Bethke@39:176/208.0
  87.